Accessing Graphics Exporter Settings17

Graphics exporters may implement some or none of these functions. To determine whether a particular setting is available, use CallComponentCanDo .

GraphicsExportSetDontRecompress

Requests that the original compressed data not be decompressed and recompressed, but be copied (possibly with modifications) through to the output file.



 
pascal ComponentResult GraphicsExportSetDontRecompress (

                                         GraphicsExportComponent ci,

                                         Boolean dontRecompress);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
dontRecompress: If true , requests not to recompress the image data.

GraphicsExportGetDontRecompress



 
pascal ComponentResult GraphicsExportGetDontRecompress (

                                         GraphicsExportComponent ci,

                                         Boolean *dontRecompress);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
dontRecompress: Points to a Boolean to receive this setting.

GraphicsExportSetInterlaceStyle

Defines the interlace style.



 
pascal ComponentResult GraphicsExportSetInterlaceStyle (

                                         GraphicsExportComponent ci,

                                         unsigned long interlaceStyle);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.



 
interlaceStyle

The new interlace style to use. Valid values and interpretations are defined by individual exporters.

DISCUSSION

A common use for this function is in the PNG and GIF formats, which rearrange data so that low-resolution images can be displayed from incomplete data streams. In QuickTime 4, the PNG graphics exporter supports the InterlaceStyle settings kQTPNGInterlaceNone and kQTPNGInterlaceAdam7 .

GraphicsExportGetInterlaceStyle

Returns the interlace style.



 
pascal ComponentResult GraphicsExportGetInterlaceStyle (

                                         GraphicsExportComponent  ci,

                                         unsigned long *interlaceStyle);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
interlaceStyle: Points to a variable to receive the interlace style.

GraphicsExportSetMetaData

Defines supplemental data, such as textual copyright information.

In QuickTime 4, none of the supplied graphics exporters support setting MetaData .



 
pascal ComponentResult GraphicsExportSetMetaData (

                     GraphicsExportComponent ci,

                                         void *userData);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
userData: Contains a pointer to a user data structure. The value you pass should have parameter type UserData .

GraphicsExportGetMetaData

Returns the current MetaData setting.

In QuickTime 4, none of the supplied graphics exporters support setting MetaData .



 
pascal ComponentResult GraphicsExportGetMetaData (

                     GraphicsExportComponent ci,

                                         void *userData);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
userData: Contains a pointer to a user data structure. The value you pass should have type UserData .

GraphicsExportSetTargetDataSize

Defines a desired maximum data size and asks for a quality that does not exceed that size.



 
pascal ComponentResult GraphicsExportSetTargetDataSize (

                                         GraphicsExportComponent ci,

                                         unsigned long targetDataSize);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
targetDataSize: A value describing the maximum size of the image data in bytes.

GraphicsExportGetTargetDataSize

Returns the current desired maximum data size.



 
pascal ComponentResult GraphicsExportGetTargetDataSize (

                                         GraphicsExportComponent ci,

                                         unsigned long *targetDataSize);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
targetDataSize: Points to a variable to receive the desired maximum data size in bytes.

GraphicsExportSetCompressionMethod

Defines the compression method to use.



 
pascal ComponentResult GraphicsExportSetCompressionMethod (

                     GraphicsExportComponent ci,

                                         long compressionMethod);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
compressionMethod: A value describing the compression algorithm to be used by the graphics exporter.

DISCUSSION

Some image formats, such as TIFF, support several compression methods. In QuickTime 4.0, the TIFF graphics exporter supports the CompressionMethod settings kQTTIFFCompression_None and kQTTIFFCompression_PackBits .

GraphicsExportGetCompressionMethod

Returns the compression method.



 
pascal ComponentResult GraphicsExportGetCompressionMethod ( GraphicsExportComponent ci,

                                         long *compressionMethod);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
compressionMethod: Points to a value to receive the compression method.

GraphicsExportSetCompressionQuality

Defines the compression quality. This setting is only supported by lossy compression methods.



 
GraphicsExportSetCompressionQuality (

                     GraphicsExportComponent ci,

                                         CodecQ spatialQuality);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
spatialQuality: The currently specified quality value.

GraphicsExportGetCompressionQuality

Returns the compression quality value.



 
pascal ComponentResult GraphicsExportGetCompressionQuality ( GraphicsExportComponent ci,

                                         CodecQ *spatialQuality);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
spatialQuality: Points to a variable to receive quality value.

GraphicsExportSetResolution

Defines the resolution to store in the image file.



 
pascal ComponentResult GraphicsExportSetResolution (GraphicsExportComponent ci,

                                         Fixed horizontalResolution,

                                         Fixed verticalResolution);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
horizontalResolution: A value describing the horizontal resolution of the image.
verticalResolution: A value describing the vertical resolution of the image.

The value 0x00480000 represents 72.0 dpi.

GraphicsExportGetResolution



 
pascal ComponentResult GraphicsExportGetResolution (GraphicsExportComponent ci,

                                         Fixed *horizontalResolution,

                                         Fixed *verticalResolution);

horizontalResolution: Points to a variable to receive the horizontal resolution.
verticalResolution: Points to a variable to receive the vertical resolution.

GraphicsExportSetDepth

Defines the depth to use. Some image file formats support more than one pixel depth.

In QuickTime 4, the BMP, JPEG, Photoshop, PNG, PICT, QuickTime Image, Targa and TIFF graphics exporters support the depth setting.



 
pascal ComponentResult GraphicsExportSetDepth (

                     GraphicsExportComponent ci,

                                         long depth);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
depth: A value describing the depth of the image data.

GraphicsExportGetDepth

Returns the current depth setting.



 
pascal ComponentResult GraphicsExportGetDepth (

                                         GraphicsExportComponent ci,

                                         long *depth);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
depth: Points to a variable to receive the depth.

GraphicsExportSetColorSyncProfile

Sets the ColorSync profile to embed in the image file.



 
pascal ComponentResult GraphicsExportSetColorSyncProfile ( GraphicsExportComponent ci,

                                         Handle colorSyncProfile);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
colorSyncProfile: A handle containing the ColorSync profile.

DISCUSSION

This allows image files to describe their native colorspace in a self-contained manner. In QuickTime 4, the JPEG, PNG, PICT, QuickTime Image and TIFF graphics exporters support embedded ColorSync profiles.

GraphicsExportGetColorSyncProfile

Gets the current value of this setting.



 
pascal ComponentResult GraphicsExportGetColorSyncProfile ( GraphicsExportComponent ci,

                                         Handle *colorSyncProfile);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
colorSyncProfile: Points to a variable to receive the ColorSync profile as a newly allocated handle.

The caller is responsible for disposing of the returned handle.